Set Virtual Machine Title 

Sets the virtual machine title to the given string. Applications should not change the virtual machine title except under explicit instructions from the user.

mov  ah, 16h           ; Windows multiplex function

mov  al, 8Eh           ; VM Title

mov  di, seg VMTitle   ; see below

mov  es, di

mov  di, offset VMTitle

mov  dx, 1             ; Set Virtual Machine Title

int  2Fh

cmp   ax, 1

je   success

Parameters

VMTitle

Address of a null-terminated string specifying the virtual machine title. The title must not exceed 30 characters, including the terminating null character. If this parameter is zero or points to an empty string, the function removes the current virtual machine title.

Return Value

Returns 1 in the AX register if successful or zero otherwise.

Remarks

Although not common, Set Virtual Machine Title may return 1 in the AX register even though the title was not changed. In general, applications must not rely on the operating system to keep an accurate copy of the current title.